GET_NAMED_MEMORY-Baustein
Kurz-Information
Name |
|
→POE-Typ |
|
Kategorie |
Standard (non-safe), MemoryEnh, Baustein mit interner Fehlerdiagnose |
Konform zur →IEC-Norm |
nicht in IEC-Norm vorgesehen |
Grafische Schnittstelle |
|
Verfügbar ab |
Version 1.38.0 (für Neuron Power Engineer) und Version 2.3.1602 von Neuron RTS max - Anfangsvariante Version 1.109.0 (für Neuron Power Engineer) und Version 3.19.0 von Neuron RTS max: liefert die Referenz auf gleichen Speicherbereich wie Version 3.2.2 (für Bibliothek Version 3.8.0 (für Bibliothek |
Funktionalität
Der Baustein liefert die →Referenz auf einen Speicherbereich, dessen Namen Sie am Eingang NAME
eingeben.
Beim ersten Aufruf des Bausteins wird der angeforderte Speicher im dynamischen Speicher des Zielsystems (Heap) allokiert und eine Referenz darauf geliefert. Der durch den Ergebniswert referenzierte Speicherbereich wird bei der Anforderung mit 0
initialisiert. Bei jedem weiteren Aufruf des Bausteins wird eine Referenz auf den bereits allokierten Speicher geliefert.
Bei einem →Kaltstart oder →Warmstart der Anwendung wird ein allokierter Speicher automatisch freigegeben.
Da zusätzlich zum Namen des Speicherbereichs auch Typinformationen des Ergebniswerts gespeichert werden, ist es nur zulässig, den Aufruf des Bausteins auf der rechten Seite des Zuweisungsoperators ":=
" für →Zuweisungen auf eine Referenz-Variable zu verwenden. Die Größe des Speicherbereichs ergibt sich aus dem Datentyp der Referenz-Variable.
Eingänge, Ausgänge, Ergebniswert
|
Bezeichner |
Beschreibung |
|
---|---|---|---|
Eingänge: |
|
|
Name des Speicherbereichs |
Ausgänge: |
|
|
Ergebniscode der Zuweisung:
|
Ergebniswert: |
– |
eine →Referenz auf die folgenden Datentypen: |
typisierte Referenz auf den angeforderten Speicherbereich oder |
Der Eingang EN
und der Ausgang ENO
sind für den →Aufruf des Bausteins verfügbar. Siehe "Ausführungssteuerung: EN, ENO" für Informationen zum Eingang EN
und zum Ausgang ENO
.
Informieren Sie sich unter:
-
"Bausteine für sichere Logik", ob dieser Baustein für das Entwickeln von sicherheitsrelevanten Anwendungen unterstützt wird.
-
"Kennzeichnung von sicherer Logik im FBS-Editor", welche Auswirkung die Verwendung des Bausteins als Baustein für sichere Logik hat.
Interne Fehlerdiagnose für Baustein
Der Baustein prüft die folgenden Fehlerfälle:
-
Es ist kein weiterer Speicher auf dem Zielsystem mehr verfügbar.
-
Der Datentyp der Variable, auf die zugewiesen wird, stimmt nicht mit dem Datentyp des Speicherbereichs überein.
-
Der RTSSMem-Systemdienst wurde nicht geladen.
In einem solchen Fehlerfall wird der Ausgang ENO
des Bausteins auf den Wert FALSE
(oder eine Entsprechung) zurückgesetzt. Zusätzlich liefert der Ausgang RC
den entsprechenden Ergebniscode (siehe die vorhergehende Tabelle unter RC
) und der Baustein selbst liefert NULL
(als Ergebniswert).
Beispiel für Verwendung im ST-Editor
Verwendungsbeispiel des GET_NAMED_MEMORY-Bausteins |
---|
|
Neuron empfiehlt, den GET_NAMED_MEMORY
-Baustein für jeden anzufordernden Speicherbereich höchstens einmal aufzurufen. Einerseits kann das Zeitverhalten bei der Speicheranforderung unvorhersehbar sein, andererseits kann das Ermitteln des bereits allokierten Speicherbereichs einen längeren Zeitraum in Anspruch nehmen. Das folgende Beispiel demonstriert die einmalige Verwendung:
Empfohlene Verwendungsweise des GET_NAMED_MEMORY-Bausteins |
---|
|
Bei der Erstellung Ihrer Anwendung im ST-Editor erstellen Sie den Aufruf eines Bausteins, indem Sie den laut Syntax erforderlichen Text eintippen oder die Inhaltshilfe verwenden.